影音入库箱 v5.7 —— 使用说明
播放文件 · 影片信息 · 封面 · 字幕，一次整理入库
================================================

一、这个包是什么
1. 影音入库箱 v5.7.html
   单文件工具，双击用 Chrome / Edge / Firefox / Safari 打开即可，不需要安装任何东西。除你主动开启「写入 OpenList」外，处理都在本机浏览器完成，不上传文件。
2. NFO示例/
   刮削后目录里会生成的 NFO 长什么样，可用来对照检查（tvshow.nfo / season.nfo / 单集 .nfo / movie.nfo）。

二、核心变化：播放文件和封面合成一个页面
已经没有单独的「元信息刮削」页。主界面一次完成：
- 生成 Jellyfin / Emby 能识别的播放文件（.strm）；
- 生成影片信息文件（tvshow.nfo / season.nfo / 单集 .nfo / movie.nfo）；
- 下载官方海报、背景图、季海报（有 TMDB Key 时）；
- 抓不到官方图时，自动生成本地标题封面；
- 全部打进同一个 zip，解压出来就是按「剧名/Season」分好的文件夹。

默认已按推荐配置自动优化：生成单集 NFO、官方海报 / 背景图 / 季海报，抓不到海报自动生成本地标题封面，默认打包成一个 zip；不需要客户逐项选择。只有特殊需求才展开「专家选项」。

有 TMDB Key：完整简介、评分、演职员、官方图。
没有 Key：照样生成基础影片信息 + 本地封面，Jellyfin / Emby 不联网也能识别。
免费申请 Key：在「封面与保存」里点「打开 TMDB 申请页 ↗」，或直接打开
https://www.themoviedb.org/settings/api
登录后按「设置 → API → 创建 API Key」操作，拿到 Key 粘贴回输入框即可。
Key 只存本机浏览器，不会发给作者；导出配置时会自动去掉 Key / Token，点「清除 TMDB Key」可一键清空。
如果浏览器没有自动打开新标签页，页面会弹出可复制的申请网址；也可以直接复制上面这一行网址到浏览器地址栏打开。
没有 Key 时主界面会显示一行提示；第一次点生成会弹窗说明「会生成什么、不会有什么」，可点「先这样生成」，也可点「去申请 Key」。

三、操作步骤
1. 打开 HTML。需要自动上传时，先确认左上角显示「OpenList 已连接」（默认 http://127.0.0.1:5244，admin/admin）。只下载 zip 可以不连。
2. 点「① 选择云盘视频目录」，选装视频的文件夹，剧名 / 季号会自动推断。
3. 在「② 保存到媒体库」填你实际的媒体库文件夹：剧集一般填 /媒体库/剧集，电影填 /媒体库/电影，也可以填剧名文件夹的上一级。
4. 直接点「③ 开始生成（播放文件 + 封面）」。封面、NFO、单集信息已默认自动生成，不需要逐项勾选。
5. 完成后点「↓ 下载合并包」，把 zip 解压到第 3 步填的媒体库文件夹。
6. 到 Jellyfin / Emby 扫描媒体库；已有剧集要「刷新元数据 → 替换所有元数据（含图像）」。

界面只有两个页签：「批量生成播放文件 + 封面」和「批量打包字幕」。
主卡片只保留选择视频目录、保存位置和生成按钮；封面与影片信息默认自动生成。参数、OpenList、TMDB、写入方式都收在「高级设置（一般不用改）」里，运行日志默认收起。
不想解压：展开「高级设置 → 封面与保存 → 专家选项」，勾「直接写入媒体库」会直传；写失败自动退回 zip。想直接写进本地文件夹，点同一处的「选择本地文件夹（可选）」。
只想给已有影片补封面和信息、不重新生成播放文件：展开页面底部「给已有影片补封面和信息（可选）」。

四、合并包目录结构
剧集/
  钢之炼金术师/
    tvshow.nfo
    poster.jpg
    fanart.jpg
    season01-poster.jpg
    Season 01/
      season.nfo
      poster.jpg
      钢之炼金术师 S01E01.strm
      钢之炼金术师 S01E01.nfo
      钢之炼金术师 S01E02.strm
      钢之炼金术师 S01E02.nfo
电影：
  片名/
    片名.strm
    movie.nfo
    poster.jpg
    fanart.jpg

五、刮完还是没封面？Jellyfin / Emby 四项设置
1. 控制台 → 媒体库 → 元数据读取器：把「NFO」调到第一位。
2. 元数据语言：简体中文。
3. 图像抓取器：勾选「本地图片」（背景图 fanart/backdrop 也勾上）。
4. 对该剧集执行「刷新元数据 → 替换所有元数据（含图像）」；或者整库「扫描媒体库」。

六、常见问题
1. 自动匹配全是「未匹配」：TMDB 不可达。填 TMDB Key，或把 TMDB 地址改成反代地址；不填也能生成本地 NFO + 本地封面。
2. 合并包解压后 Jellyfin 不认：确认解压到了媒体库的剧集 / 电影文件夹，且目录里是「剧名/Season 01/」结构。
3. 已有剧集看不到新封面：必须做第五节第 4 条刷新，Jellyfin 不会自动重读已存在条目的图片。
4. 只想生成播放文件：展开「封面与保存 → 专家选项」，取消「同时生成封面和影片信息」即可，行为和以前一样。
5. 上传失败：多为云盘驱动不支持写入，或 OpenList 没写权限。用合并 zip 解压即可。
6. 媒体库路径不确定：先按 /媒体库/剧集 或 /媒体库/电影 填；填错也不影响生成 zip，解压时放对位置就行。

七、浏览器兼容
- Chrome / Edge（Windows / macOS / Linux）：功能最完整，支持直接选择本地文件夹写入。
- Firefox / Safari：生成播放文件、字幕打包、下载 zip、写入 OpenList 都可用；浏览器不支持直接写本地文件夹时，按钮会自动隐藏，结果自动打包成 zip，不影响主流程。
- Safari 若提示不支持 GB18030：个别 GBK / GB2312 中文字幕可能乱码，请改用 Chrome / Edge，或先把字幕转成 UTF-8。
- 所有浏览器都要求能访问 OpenList；跨域失败时按页面提示检查 OpenList 的 CORS 配置。
